home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / il_c / ilMpRequest.z / ilMpRequest
Encoding:
Text File  |  2002-10-03  |  5.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. iiiillllMMMMppppRRRReeeeqqqquuuueeeesssstttt((((3333))))     IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiillllMMMMppppRRRReeeeqqqquuuueeeesssstttt((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiillllMMMMppppRRRReeeeqqqquuuueeeesssstttt - a concurrently executed request
  10.  
  11. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  12.      ilMpNode
  13.  
  14. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  15.      #include <il/ilCdefs.h>
  16.  
  17. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      ilMpRequest is derived from ilMpNode and represents an individual unit of
  19.      processing for a parallel operation managed by ilMpManager (also derived
  20.      from ilMpNode).
  21.  
  22. CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY
  23.      CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr
  24.  
  25.      SSSSyyyynnnnccccrrrroooonnnniiiizzzzaaaattttiiiioooonnnn mmmmeeeetttthhhhooooddddssss
  26.  
  27.           void ilMpRequestPark(ilMpRequest *obj, ilMpRequest* reqToPark)
  28.  
  29.      GGGGeeeetttt////sssseeeetttt mmmmeeeetttthhhhooooddddssss
  30.  
  31.           ilMpManager* ilMpRequestGetParent(ilMpRequest *obj)
  32.           void ilMpRequestSetNextState(ilMpRequest *obj, ilMpState next)
  33.           ilMpState ilMpRequestGetNextState(ilMpRequest *obj)
  34.  
  35.      DDDDeeeeffffeeeerrrrrrrreeeedddd eeeennnnqqqquuuueeeeuuuueeeeiiiinnnngggg
  36.  
  37.      RRRReeeeqqqquuuueeeesssstttt pppprrrroooocccceeeessssssssiiiinnnngggg
  38.  
  39. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  40.      ggggeeeettttNNNNeeeexxxxttttSSSSttttaaaatttteeee(((())))
  41.  
  42.           ilMpState ilMpRequestGetNextState(ilMpRequest *obj)
  43.  
  44.  
  45.           This method returns the next state for this request. See the
  46.           sssseeeettttNNNNeeeexxxxttttSSSSttttaaaatttteeee() method for more details.
  47.  
  48.      ggggeeeettttPPPPaaaarrrreeeennnntttt(((())))
  49.  
  50.           ilMpManager* ilMpRequestGetParent(ilMpRequest *obj)
  51.  
  52.  
  53.           This is a specialized version of iiiillllMMMMppppNNNNooooddddeeee::::::::ggggeeeettttPPPPaaaarrrreeeennnntttt() that casts
  54.           the parent to an ilMpManager (since request's parents are always
  55.           managers.
  56.  
  57.      ppppaaaarrrrkkkk(((())))
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiillllMMMMppppRRRReeeeqqqquuuueeeesssstttt((((3333))))     IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiillllMMMMppppRRRReeeeqqqquuuueeeesssstttt((((3333))))
  71.  
  72.  
  73.  
  74.           void ilMpRequestPark(ilMpRequest *obj, ilMpRequest* reqToPark)
  75.  
  76.  
  77.           This method is used to defer processing of a request when it needs
  78.           to wait on the completion of this request (e.g. because this request
  79.           is already doing the same work but we don't want the parked
  80.           request's dependencies to be satisfied until this request
  81.           completes).
  82.  
  83.      sssseeeettttNNNNeeeexxxxttttSSSSttttaaaatttteeee(((())))
  84.  
  85.           void ilMpRequestSetNextState(ilMpRequest *obj, ilMpState next)
  86.  
  87.  
  88.           This method sets the next state for this request. The next state
  89.           info is used when a request phase completes and the request is ready
  90.           to transition to the next phase. This method can be used to override
  91.           the default transitions for a request.
  92.  
  93. IIIINNNNHHHHEEEERRRRIIIITTTTEEEEDDDD MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  94.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllMMMMppppNNNNooooddddeeee
  95.      ilMpNodeAddProcessingTime(), ilMpNodeGetDepth(), ilMpNodeGetParent(),
  96.      ilMpNodeGetProcessingTime(), ilMpNodeGetState(), ilMpNodeGetStatus(),
  97.      ilMpNodeGetTimingWeight(), ilMpNodeInhibitAbort(), ilMpNodeIsAborting(),
  98.      ilMpNodeSetTimingWeight()
  99.  
  100. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  101.      ilMpNode(3), ilMpManager(3)
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.